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Deploying Your Application 


Introduction 


With LiveCode, it is easy to deploy your application to anyone. 


Using the standalone building capability in LiveCode you can create a native application for each operating system 
you want to support. Users who do not have LiveCode can run these applications like any other application they 
download and install. Standalone applications can have their own identity as true applications, include icons, 
document associations and more. 


Building a Standalone Application 


When you have finished your LiveCode application and what to distribute it you can build it into a standalone 
application. These applications do not require users to have LiveCode. All of LiveCode's feature set is available for 
use in a standalone application, with the exception that you cannot set scripts on objects. 


The builder itself will let you build standalone applications for any platform it supports, from any platform it supports 
with the exception that iOS standalones must be built on Mac OS X. For example you can build a Windows 
standalone on a Mac OS X machine. However, you may wish to check that your application looks and behaves 
correctly on each platform you intend to support. Please note it is inherently harder to debug an application that has 
been built as a standalone, so you should test your application as thoroughly as possible before building it. 


Related lessons: 


e Building Standalone Applications 
« How do! Develop Cross-Platform in LiveCode? 


Step by step 

Deploying an app to standalone is straightforward: 

1) Open your stack in the LiveCode IDE 

2) Select File — Standalone Application Settings... from the menu bar 

3) Select the settings for your app 

4) Make sure that checkboxes for each platform you wish to build for are checked 
5) Close the standalone settings window 

6) Select File + Save as Standalone Application... from the menu bar 


Your application will be packaged up and placed in the selected output folder. 


Standalone Applications Settings 
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The Standalone Applications Setting dialog allows you to create settings for your standalone application. This dialog 
can be found in the File menu. The settings you enter are applied to the current front most editable stack and are 
saved with the stack. This means you only need to enter the settings once for each application you create. The same 


settings will apply if you do another build in the future. 


Related lessons: 


e The Standalone Application Settings 


General Settings 








ee Standalone Application Settings for Untitled 1 - General 
om & i « 8 
% rea Xy Aw iOS * 
General Stacks Copy Files |nclusior Mac Windows Linux iOS Android HTML5 Bug Reports 
Standalone name: Untitled 1 (Don't include “.exe" or “.app") 
Inclusions 


Oo Search for required inclusions when saving the standalone application 


Select inclusions for the standalone application 


Property Profiles 





© Remove all profiles on objects 
Set all objects to profile: 
Include profiles on objects and the profile library 


| ude all profiles Or nclude profiles selected t 


Other 
Master 


Default build folder: /Users/alilloyd/Desktop 


Automatically build here 


Figure 1 — Standalone Settings — General Tab 


Mode Choose between the different standalone application settings screens. 
Selector 


Standalone Set the name of your standalone application. This should be the name you want your 
Name finished application to have. Don’t include a file extension (.exe on Windows or .app on Mac 
OS X) as the standalone builder can create standalones for multiple platforms and will add 


the appropriate extension automatically. 
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Inclusions | Choose the components you want to include in a standalone. You may either choose to 
Selector search for required inclusions automatically, or manually select the components you want to 
include. 


Search for Inclusions 


This is the default option. When selected, LiveCode will search your application stack file (main stack and sub 
stacks) to attempt to determine what components your application uses. It will then include those items. 


Select Inclusions for the Standalone Applications 


Select this option if you want to specify the components to include manually. You may wish to use this option if your 
application dynamically loads components that cannot be searched at this point automatically, or if you know exactly 
what components your application uses and wish to speed up the standalone building process by skipping the 
automatic search step. 


It is important that you choose to include all the components that your application uses or it may fail. If you do not 
include your own custom error reporting or LiveCode’s standalone error reporting dialog (discussed below) such 
failure may be silent — i.e. an operation in your standalone will simply cease working without displaying anything to 
the user. | 


Profiles Choose between the Property Profile settings options. You only need to alter settings in 
Settings this area if you have used Property Profiles (see the section on Property Profiles in 
Chapter 4, Builder a User Interface above) 


Remove all Removes all profiles and builds the standalone using the currently active profile on each 
profiles object. Select this option if you don't need to change profile in the standalone and want to 
save disk space by removing extraneous profile information. 


Set all Set all objects to a specific profile then remove the profile data from objects. 
objects to 

profile 

Include Include the profile library and allow switching between profiles in the standalone 


profiles and = application. You can choose whether to include specific profiles or all profiles. 
the profile 
library 


Including Additional Stacks 
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tT ts) Standalone Application Settings for Untitled 1 - Stacks 
ay Ly i e 8 
e “oe AG ios ig! + 
General Stacks Copy Files Inclusions Mac Windows Linux iOS Android HTML5 Bug Reports 








Stack files in the application: 





Figure 2 — Standalone Settings — Stacks Tab 


Stack Files Use this section to add additional stack files to your application. Any stacks you add to 


this section will be added to the stackFiles property of the main stack of your 
standalone. This means that any scripts within your standalone application will be able to 
locate and reference these stacks by name. 


Advanced Use this section to control exactly how multiple stack files are managed in your 

Options standalone. 

Move If you select this option, each of the sub stacks in the stack files you select will be moved 
substacks into their own individual file, located in the data folder or within the application bundle of 
into your standalone. 

individual 

files 

Rename Renames each sub stack file using a number on disk (instead of using the name of the 
stackfiles sub stack). Select this option if you do not want the names you have selected for stacks 
generically to be visible to the end user in the filing system. 
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Create folder Creates a folder and places the stack files into that folder, instead of storing them at the 

for stackfiles same level as the standalone executable. All references in the stackFiles property will 
refer to this folder using a relative path so the stacks can still be located by the 
standalone application. 


Individual Select a stack file on the left then an individual stack from within the file to set options on 
stack that stack. 

options 

Set Set this option if you want the selected stack file to be removed from memory when it is 


destroyStack closed. This option is useful if you are loading large stacks into memory and want them to 
to true be removed when they are closed. 


Encrypt with Secures the scripts within the selected stack file with a password. This provides a basic 
password level of encryption that prevents someone from casually reading the scripts in the stack 
by opening the file in a binary file viewer. 


Note: A stack file directly attached to a standalone application cannot have changes saved to it. This stack is 
bound directly to the executable file that runs. The OS locks an executable file while it is running. If you want to 
save changes in your standalone application, split your stack up until multiple files. A common technique is to 
create a "splash screen" stack that contains a welcome screen and then loads the stacks that make up the rest of 
your application. These stacks are referenced aS stackFiles on this pane in the standalone settings screen. It is 
thus possible to automatically update these component stacks, or to save changes to them. You may also want to 
consider creating preference files in the appropriate location on your end user's system (see 

the specialFolderPath function and query/setRegistry functions for more information). 


Note: Adding additional stacks to the stacks tab is not supported for iOS, Android or HTML5 standalones. 
Additional stacks may be included via the Copy Files tab. 


Including Additional Files 
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ee Standalone Application Settings for Untitled 1 - Copy Files 


% © t- 


X a A os 


Mac Windows Linux iOS Android 


BD & 


HTML5- Bug Reports 





General Stacks Copy Files |nclusions 


Non-stack files in the application: 


Add File... 
Add Folder... 


Remove Entry 





Copy Referenced Files 


Destination Folder Referenced Files 





Figure 3 — Standalone Settings — Copy Files 


Non-stack List other files to be included in the standalone. Use this feature to include help documents, 
files inthe — read me files and other resources that you want to include with your standalone each time 


application you build. 


Copy Loops over all image and player objects in stacks and copies any files referenced in 

Referenced the fileName property of these objects into the standalone. Then automatically sets 

Files the fileName property to reference these files in the standalone using referenced file 
paths. 


Destination Create a subfolder within your standalone to copy the image and movie files to. 


folder 


Including Additional Resources 
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ee Standalone Application Settings for Untitled 1 - Inclusions 
% et X% «= A ios @# DH & 

| General Stacks Copy Files Inclusions Mac Windows Linux iOS Android HTML5 Bug Reports 
f=) JSON Library X & Ais# 8 
=) Icon SVG Library X & Aios OE 
(>) Animation X & A ios @ 

(>) DataGrid X & Aios @ 

(>) Geometry X £7 A ios & 

(>) Internet X & A ios § 

(>) Printing X aF 4 ios @ 

(>) Table X & Aios @ 

(>) XMLRPC X & A ios 

= ODBC Xa 

= PostgreSQL X a ray 

= SaLite X & Aios @ 

= MySQL X & Aios 








Figure 4 — Standalone Settings — Inclusions 


The list of resources available to select for inclusion in a standalone application are a combination of currently 
installed LiveCode Builder extensions, externals and database drivers (both built-in and those found in user folders), 
and built-in resources and script libraries. 


The following built-in resources are available by default: 


Ask Dialog _ This option is required if any of your scripts use the "ask" or "ask password" commands. 
The standalone builder will copy the stack "ask dialog" from the IDE into your standalone as 
a sub stack. The standalone builder makes a copy of your stack before adding resources to 
it as part of the build process, so your original stack is unaltered. 
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Answer 
Dialog 


Browser 


Browser 
(CEF) 


Brushes 


Cursors 


Database 


Magnify 


PDF 
Printer 


Print 
Dialog 


SSL & 
Encryption 


XML 
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This option is required if any of your scripts use the "answer" command. Note that this only 
applies to the dialog form of the command. The answer file / printer / color / effect / folder / 
page setup / printer and record forms of the command do not require this option. The 
standalone builder will copy the stack "answer dialog" into your standalone. 


This option is required if your application uses the embedded browser or 
any revBrowser Command. 


This option is required if your application uses the embedded CEF browser or 
any revBrowser Command. 


This option is required if your application uses any of LiveCode's brush cursors. It is not 
required if your application does not make use of the painting commands. It copies the stack 
"brushes" into your standalone. 


This option is required if your application uses any of LiveCode's cursors. It is not required if 
your application only uses OS cursors. It copies the stack "cursors" into your standalone. 


This option is required if your application uses database access or 
any revDatabase command. 


This option is required if your application uses the magnify palette. 

This option is required if your application uses the "open printing to pdf" command. 

This option is required if your application uses LiveCode's built-in print or page setup dialogs 
(e.g. for use on Linux without GTK installed). It is not required if you only display the system 


printer and page setup dialogs. It copies the stack "print dialog" and "page setup" into your 
standalone. 


This option is required if your application uses any SSL or encryption related commands 


This option is required if your application uses any revxMi Commands 


The following script libraries are available by default: 


Library Name 
Animation 
DataGrid 
Geometry 


Internet 


Automatic inclusion condition 
This library is unsupported. 
DataGrid object. 

Geometry properties or commands. 


Internet access, including URL, ftp & POST 
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Library Name 
Printing 

Zip 

Speech 

Table 


XMLRPC 
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Automatic inclusion condition 

revPrintField , revShowPrintDialog and revPrintText 

All revzZip commands (but not required for compress / decompress ) 
revSpeak and revSpeechVoices 

Use of the table object 


Any revxXMLRPC commands 


The following database drivers are available by default: 


e ODBC 
e MySQL 
e SQLite 


e PostgreSQL 


Mac Deployment Settings 
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|\@@ Standalone Application Settings for Untitled 1 - OS X 
% _ & XX a AW ios @ DB & 
General Stacks Copy Files [nclusions Mac Windows Linux iOS Android HTML5 Bug Reports 
Build for: & Mac OS X 32-bit _| Mac OS X 64-bit (EXPERIMENTAL) 
Application Icon: Use None | Choose... 
Document Icon: Use None | Choose... 





Icons to display on ask and answer dialogs 


Application Icon: a Small Application Icon: “ 


Version Information 








PLIST 
© Enter the information and have LiveCode write the PLIST file for you 
~) Choose a PLIST file to import into the application bundle 


Name: Untitled 1 Document Type: 


Signature: ???? Document Extension: 





Short Version: 1.0.0.0 Long Version: | Untitled 1 1.0.0.0 
Get Info String: Untitled 1 Version 1.0.0.0 
Copyright Notice: 2016 All rights reserved worldwide 


Bundle Identifier: com..untitled1 


Figure 5 — Standalone Settings — Mac 


Build for 
Mac OS X 
32-bit 


Build for 
Mac OS X 
64-bit 


Application 
Icon 


Document 
Icon 


Build a standalone that includes a 32 bit slice. 


Build a standalone that includes a 64 bit slice. 


Choose an application icon to represent the application in the Finder. The icon should be in 
icns format. 


Choose a document icon to represent your application's documents in the Finder. The icon 
should be in icns format. 
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Icons for 
ask / 
answer 
dialogs 


PLIST — 
enter 
information 
and have 
LiveCode 
write the 
PLIST 


Choose a 
file to 
import into 
the 
application 
bundle 


Short 
version / 
long 
version 


Get info 
string 


Copyright 
notice 


Bundle 
identifier 
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Choose an icon to display whenever you use the ask or answer commands to display a 
dialog. On Mac OS X, the convention is that these dialogs should display your application 
icon. The icon should be stored in your stack as an image, or selected from LiveCode's 
built-in icons. If you have used a built-in icon, be sure to select the relevant inclusion on the 
General tab (if you are selecting inclusions manually). 


Have LiveCode fill out the PLIST for your application automatically. The PLIST is a settings 
file stored in XML format stored as part of every Mac OS X application. It contains 
information about the application, including its name, version number, copyright notice and 
document associations. Having LiveCode create this file for you is the recommended 
option. For more information about PLISTs consult Apple's developer documentation 


Choose to import a PLIST file instead of having LiveCode create one. Select this option if 
you have created your own highly customized PLIST that you want to use for your 
application in each build you create. 


The version information to be included with your standalone. 


The visible text displayed in your application's Get Info window by the Finder. 


The copyright notice for your application. 


A unique identifier for your application used by Mac OS X to identify your application. 


e Signing and Uploading apps to the Mac App Store 


Windows Deployment Settings 
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Standalone Application Settings for Untitled 1 - Windows 


me» X «& A ios @ BH & 





Build for: 


Icon 


Windows x86 Windows x86-64 





Application Icon: 32/Support/Sample Icons/genericapp.ico | Use None Choose... 


Document Icon: }2/Support/Sample Icons/genericdoc.ico UseNone Choose... 


Version Information 





Fle Description: { ie 01000 Toa] Fie version: [1 }[@ }-[0 }{0 





Copyright Notice: 2019 All rights reserved world Product Version: 1-0 - 0 - 0 
Comments: Original Filename: 
Legal Trademarks: Internal Name: 
Product Name: Untitled 1 Private Build: 
Company Name: Special Build: 
UAC Execution Level Hi-DP! support 
Default Enable Hi-DPI scaling 
Runs with default UAC access. No If enabled, stacks will be automatically 


manifest is included. scaled to match the system display 


Figure 6 — Standalone Settings — Windows 


Build for 
Windows x86 


Build for 
Windows x86_64 


Application icon 


Document icon 


Version 
information 


Build a 32-bit standalone for the Microsoft Windows OS. 


Build a 64-bit standalone for the Microsoft Windows OS. 


Choose an application icon to represent the application in Windows. The icon should 


be in .ico format. 


Choose a document icon to represent your application's documents in Windows. The 
icon should be in .ico format. 


The version information to be stored as part of your application and displayed in the 
Windows property inspector and dialogs. 
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UAC Execution Select the user account control level that applies to your application. For more 
Level information, consult MSDN 


Linux Deployment Settings 





\@0 Standalone Application Settings for Untitled 1 - Unix | 
f=3 . a 
it me X% « Y is @ DB & 
General Stacks Copy Files |nclusions Mac Windows Linux iOS Android HTML5 Bug Reports 
Build for: Linux Linux x64 


Include: Unix File Selector 
Unix Page Setup 
Unix Printer Chooser 


Unix Color Chooser 








Figure 7 — Standalone Settings — Linux 


Build Build a standalone for 32-bit Linux 
for 
Linux 


Build Build a standalone for 64-bit Linux 
for 

Linux 

x64 
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Include Select built-in LiveCode dialogs to include. These dialogs are useful if your application may be 
run on a system that does not include these dialogs as part of the OS. You do not need to 
include these dialogs if you are running a recent version of GTK. 


IOS Deployment Settings 


\@@ Standalone Application Settings for Untitled 1 - iOS 
oe & i x» DO * 
Xt em KX ay iOS 
General Stacks Copy Files Inclusions Mac Windows Linux ios Android HTML5_ Bug Reports 





Build For: iOS Pod, iPhone and iPad 8.0 or later _| Build 32-bit slice only 


Requirements Icons Splash 


Basic Application Settings 














Display Name Version 1.0.0 Required Prohibited n/a 
) Beta version BuildNo. 1 Telephony = : ie) 
Internal App ID com.yourcompany.yourapp sia ihc! - - ° 
SMS °o 
Profile _ (none) Still Camera fe) 
Status Ger Auto-Focus Camera So 
iPhone Status Bar © Visible © Hidden Front-Facing Camera fe) 
: o: ee Camera Flash °o 
iPad Status Bar © Visible Hidden \des Camera . : re) 
Status Bar Style Default Accelerometer ; ; 06 
Orientation Options Gyroscope fo) 
Location Services fe) 
iPhone Initial Orientation Portrait GPS re] 
iPad Supported Initial Orientations: Magnetometer § o 
Portrait ~) Portrait Upside-Down Microphone o 
Landscape Left Landscape Right Game-Kit 9 
Custom URL Scheme WiFi io) 
OpenGL ES 1.1 fo) 
URL Name OpenGL ES 2.0 °o 
Font mapping 
Mapping file 


Figure 8 — Standalone Settings — iOS Basic Settings 


Build for iOS iPod, Build a standalone iOS iPod, iPhone and iPad 
iPhone and iPad 
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Build for iOS iPod and 
iPhone 


Build for iOS iPad 
Minimum version 


Build 32-bit slice only 


Display Name 
Version 

Beta version 
Build No. 


Internal App ID 


Profile 


iPhone Status Bar 


iPad Status Bar 


Status Bar Style 


iPhone Initial 
Orientation 


iPad Supported Initial 


Orientation 


Custom URL Scheme 


Mapping file 


Telephony 


Peer-Peer 
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Build a standalone iOS iPod and iPhone 


Build a standalone iOS iPad 
Choose the minimum version of iOS that your application should run on 


Only include the 32 bit slice in the standalone instead of both the 32 bit and 64 
bit slice 


The name of the application 

The version number of the application 
Enable Test Flight distribution 

The build number of the application 


The application identifier for your application. This should begin with a reverse 
domain name of a domain you own. 


The provisioning profile to sign the application with. 


Choose whether to show or hide the status bar while the application is running 
on iPhone 


Choose whether to show or hide the status bar while the application is running 
on iPad 


Set the style of the status bar while the application is running 


Set the orientation on iPhone of the application on the screen when it initialy 
starts 


Set the possible orientations on iPad of the application on the screen when it 
initialy starts 


Add a custom url scheme to the application so that it will launch when a url is 
opened that uses the scheme 


Set a font name mapping file which should contain lines 


of <mapped name>=<PostScript name> 


Choose whether telephony is required, prohibited or not applicable in order for 
the application to function 


Choose whether peer to peer is required, prohibited or not applicable in order 
for the application to function 
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SMS 


Still Camera 


Auto-focus Camera 


Front-facing Camera 


Accelerometer 


Location Services 


GPS 


Magnetometer 


Microphone 


Game-Kit 


WiFi 


Magnetometer 


OpenGL ES 1.1 


OpenGL ES 2.0 
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Choose whether SMS is required, prohibited or not applicable in order for the 
application to function 


Choose whether a still camera is required, prohibited or not applicable in order 
for the application to function 


Choose whether an auto-focus camera is required, prohibited or not applicable 
in order for the application to function 


Choose whether a front-facing camera is required, prohibited or not applicable 
in order for the application to function 


Choose whether an accelerometer is required, prohibited or not applicable in 
order for the application to function 


Choose whether location services is required, prohibited or not applicable in 
order for the application to function 


Choose whether GPS is required, prohibited or not applicable in order for the 
application to function 


Choose whether a magnetometer is required, prohibited or not applicable in 
order for the application to function 


Choose whether a microphone is required, prohibited or not applicable in order 
for the application to function 


Choose whether Game-kKit is required, prohibited or not applicable in order for 
the application to function 


Choose whether WiFi is required, prohibited or not applicable in order for the 
application to function 


Choose whether a magnetometer is required, prohibited or not applicable in 
order for the application to function 


Choose whether OpenGL ES 1.1 is required, prohibited or not applicable in 
order for the application to function 


Choose whether OpenGL ES 2.0 is required, prohibited or not applicable in 
order for the application to function 
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Standalone Application Settings for Untitled 1 - iOS 


me X a A is @& GB *& 


General Stacks Copy Files Inclusions Mac Windows Linux ios Android HTML5-~ Bug Reports 





Build For: iOS Pod, iPhone and iPad 8.0 or later Build 32-bit slice only 


Basic Settings Icons Splash 


Location Authorization Type 


© Always 


When In Use 
App URL Query Whitelist 


Requirements and Restrictions 


Persistent WiFi _| File Sharing 
Local Notifications Push Notifications 


| Disable ATS 


Background Execution ( Experimental ) 


Enable Background Execution 


Background 


Audio 


Location Update 


VoIP 


Newsstand Downloads 







Acts a 
Backgrour 





Bluetooth Low Energy Acc 





sory Communication 


d Fetch 


Remote Notifications 





Figure 9 — Standalone Settings — iOS Requirements 


Location 
Authorization Type 


Persistent WiFi 
File Sharing 

Local Notifications 
Push Notifications 


Disable ATS 
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Choose whether to authorize location services for just when the application is in 
use or for background use also 


Indicate the application requires persistent WiFi in order to function 
Indicate the application uses file sharing 

Indicate the application sends local notifications 

Indicate the application sends push notifications 


Disabling ATS allows your application to load insecure websites (not 
recommended). 
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Enable Background 
Execution 


Background Audio 
Location Update 
VoIP 


Newsstand 
Downloads 


External Accessory 
Communication 


Use Bluetooth Low 
Energy Accessories 


Acts as Bluetooth 
Low Energy 
Accessory 


Background Fetch 
Remote Notifications 


App URL Query 
Whitelist 
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By default LiveCode applications will exit when the user suspends them. This 
option allows the applications to remain open while in the background. 


Enable if the application plays audio while in the background. 
Enable if the application recieves location updates while in the background. 
Enable if the application handles VoIP calls while in the background. 


Enable if the application recieves newsstand downloads while in the 
background. 


Enable if the application communicates with external accessories while in the 
background. 


Enable if the application communicates with bluetooth low energy accessories 
while in the background. 


Enable if the application acts as a bluetooth low energy accessory while in the 
background. 


Enable if the application fetches data while in the background. 
Enable if the application handles remote notifications while in the background. 


Specify a list of url schemes the application needs to query to determine if there 
is an application on the device capable of handling the scheme. 
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Standalone Application Settings for Untitled 1 - iOS 


me X a A ios mw 


Inclusions Mac Windows Linux ios Android 





Build For: iOS Pod, iPhone and iPad 8.0 or later Build 32-bit slice only 


Basic Settings Requirements Splash 


Icons | Prerendered Icon 


AppStore 

iPhone 

Hi-Res iPhone 
iOS 7 Hi-Res iPhone 
iPhone 6 Plus 
iPhone X 

iPad 

Hi-Res iPad 

iOS 7 iPad 

iOS 7 Hi-Res iPad 
iPad Pro 12.9 





Figure 10 — Standalone Settings — iOS Icons 


Prerendered Icon 
AppStore 

iPhone 

Hi-Res iPhone 

iOS 7 Hi-Res iPhone 
iPhone 6 Plus 


iPhone X 
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Indicate the icons are prerendered for display 
Choose a 1024x1024 pixel png image 
Choose a 57x57 pixel png image 

Choose a 114x114 pixel png image 

Choose a 120x120 pixel png image 

Choose a 160x160 pixel png image 


Choose a 180x180 pixel png image 
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iPad Choose a 72x72 pixel png image 
Hi-Res iPad Choose a 144x144 pixel png image 
iOS 7 iPad Choose a 76x76 pixel png image 
iOS 7 Hi-Res iPad Choose a 152x152 pixel png image 
iPad Pro 12.9 Choose a 167x167 pixel png image 
| @ @< Standalone Application Settings for Untitled 1 - iOS | 
* F 0 &® &Y & A&A OF H%& FB 
General Stacks Copy Files inclusions Mac Windows Linux ios Android HTML5 _ Bug Reports 





Build For: iOS Pod, iPhone and iPad 8.0 or later _) Build 32-bit slice only 


Basic Settings Requirements Icons Splash 


Splash Screens 





Launch Image 

2x Launch Image 

3x Launch Image 

Dark Mode Launch Image 

Dark Mode 2x Launch Image 

Dark Mode 3x Launch Image 
Background Color Use system background color 





Figure 11 — Standalone Settings — iOS Splash 
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Launch Image 
2x Launch Image 
3x Launch Image 


Dark Mode Launch 
Image 


Dark Mode 2x 
Launch Image 


Dark Mode 3x 
Launch Image 


Background Color 


Use system 
background color 
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Choose a png image. This will be centered on screen. 
Choose a png image. This will be centered on screen. 
Choose a png image. This will be centered on screen. 


Choose a png image for use in dark mode. This will be centered on screen. 


Choose a png image for use in dark mode. This will be centered on screen. 


Choose a png image for use in dark mode. This will be centered on screen. 


Choose a background color for transparent areas and/or areas of the screen the 


launch image does not cover. 


Use the system background color instead of a chosen color. This will use a dark 
color in dark mode and light color in light mode. 


e« How do | Become an iOS Developer? 
e How do | build an iOS application? 


Android Deployment Settings 
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@ e@.| ) Standalone Application Settings for Untitled 1 - Android 
as . za 
xt ® X «= A io @&® BD *& 
General Stacks Copy Files Inclusions Mac Windows Linux ios Android HTML5_ Bug Reports 
Build for: Android armv7 {| Android arm64_ ‘|_| Android x86 _| Android x86_64 
Basic Application Settings Requirements and Restrictions 








Version Name 
Icon 

Splash 
Signing 

Key 


Install Location 


Custom URL 
Scheme 


Push Sender ID 


Status Bar Icon 


Identifier 


Minimum Android Version 


com.yourcompany.yourapp 


Camera 
1.0.0 Version Code 1 - 
Camera Autofocus 


Camera Flash 
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Figure 12 — Standalone Settings — Android 


Build for Android 
armv7 


Build for Android 
arm64 


Build for Android 
x86 


Include armv7 binaries in the Android standalone 


Include arm64 binaries in the Android standalone 


Include x86 binaries in the Android standalone 
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Build for Android 
x86_64 


Label 


Identifier 


Version Name 
Version Code 
Icon 

Splash 
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Status Bar Icon 


Hardware 
Accelerated 
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Camera 


Camera 
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Include x86_ 64 binaries in the Android standalone 


The application name 


The application identifier for your application. This should begin with a reverse 
domain name of a domain you own. 


The version number of your application 

The build number of your application 

The application icon 

The application splash screen (applicable to the Educational Personal license only) 
Choose to sign for development, with your own key or not to sign. 

Choose a Java keystore file to sign with. 

Allow installation onto external storage. 


Add a custom url scheme to the application so that it will launch when a url is opened 
that uses the scheme. 


The project number from Google's Cloud Messaging API. See the How do | use 
Push Notifications with Android? lesson. 


The icon shown in the status bar for a notification 


Enable hardware acceleration of the application 


The orientation on the device when the application initially launches 
Set the visibility of the status bar 


Specify the store used for the in-app purchasing API 


Choose the minimum version of Android the application should run on 


Choose whether a camera is required, prohibited or not applicable in order for the 
application to function 


Choose whether camera autofocus is required, prohibited or not applicable in order 
for the application to function 
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Camera Flash 


Front Camera 


Accelerometer 


Telephony 


Telephony CDMA 


Telephony GSM 


Fake Touch 
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Choose whether a camera flash is required, prohibited or not applicable in order for 
the application to function 


Choose whether a front camera is required, prohibited or not applicable in order for 
the application to function 


Choose whether an accelerometer is required, prohibited or not applicable in order 
for the application to function 


Choose whether telephony is required, prohibited or not applicable in order for the 
application to function 


Choose whether CDMA telephony is required, prohibited or not applicable in order 
for the application to function 


Choose whether GSM telephony is required, prohibited or not applicable in order for 
the application to function 


Choose whether fake touch is required, prohibited or not applicable in order for the 
application to function 


Choose whether a touchscreen is required, prohibited or not applicable in order for 
the application to function 


Choose whether multitouch is required, prohibited or not applicable in order for the 
application to function 


Choose whether multitouch distinct is required, prohibited or not applicable in order 
for the application to function 


Choose whether multitouch jazzhand is required, prohibited or not applicable in order 
for the application to function 


Request permission to write to external storage 


Request permission to for internet access 

Request permission to access the camera 

Request permission to read the user's contact data 
Request permission to write to the user's contact data 
Request permission to read NFC tags 


Request permission to access the device's fine location 
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Course Location Request permission to access the device's course location 


Vibration Request permission to vibrate the device 
Idle Timer Request permission for the idle timer 
Ad Support Request permission for ad support 


Related lessons: 


e LiveCode and Android Studio 
e The Basics: How do | Create Hello World on Android? 


HTML5 Deployment Settings 





@°0e Standalone Application Settings for Untitled 1 - HTML5 
-~ A i » DO * 
% me X a iOS 
General Stacks Copy Files Inclusions Mac Windows Linux iOS Android HTMLS_ Bug Reports 
Build for: HTML5 


For more information about deploying to HTMLS5, please read the "HTML5 Deployment" guide in the 
Dictionary. 





Figure 13 — Standalone Settings — HTML5 


Build for HTML5 Build a standalone for HTML5 


Almost every Internet-connected device has a web browser. If your application can run in a browser, your app can be 
used anywhere and by anyone, without any need to download or install it. 
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Related lessons: 


¢« How Do! Put My First App On the Web 
Supported browsers 
The following browsers are supported: 

e Mozilla Firefox 40.0 (or newer) 


e Google Chrome 44 (or newer) 
e Safari for Mac 9.0 (or newer) 


HTMLS5 engine features 


The HTML5 engine in this release of LiveCode has a limited range of features. You can: 


e deploy single or multiple stack applications with embedded resources. Stacks other than the main stack will open 
in their own floating container windows. 

e use most of the engine's built-in controls and graphics capabilities. 

e read and write temporary files in a special virtual filesystem (which is erased when the user navigates away from 
the page) 

e use LiveCode Builder widgets and extensions 

e interact with JavaScript code in the web page using do <script> as "JavaScript" 

e call JavaScript from LiveCode Builder widgets and extensions using the com.livecode.emscripten module 

e implement widgets by embedding DOM elements as native layers 

e perform basic networking operations using the load command 


Several important features are not yet supported: 


e multimedia (the "player" control) 

Two important unsupported features are unlikely to be added in the near future: 
e operations that need to pause the script while something happens (e.g. wait 10 ) 
e externals (including revdb) 

Contents of the HTML5 standalone 


The HTML5D standalone contains four files: 


e A standalone archive, named standalone.zip by default. This file contains your application and all of the 
resources that it depends on. When the engine runs, the filesystem that's visible to the engine (e.g. via 
the open file syntax) is based on the contents of the standalone archive. 


e The engine itself, which consists of two files. The .js file contains the engine's executable code, and 
the .ntml.mem file contains essential data that's needed for the engine to run. These files are always the same, 
and only change when LiveCode is upgraded. 


e Atest HTML page. This can be opened in a browser and will correctly prepare, download and start your HTML5 
app in a convenient test environment. 


Advanced: HTML5D standalone filesystem 
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JavaScript applications running in a browser don't have access to the host system's filesystem. Instead, the 
filesystem-related features of LiveCode, such as open file , use a virtual filesystem (VFS) that exists only in 
memory. This filesystem is initialised before the engine starts, and is reset and its content discarded when the engine 
stops (when the user closes the browser view or navigates to a different page). 


During engine startup, the VFS is populated from the contents of the standalone.zip file that's created by the 
HTML5 deployment process. All of the initial files are stored in /boot/ inthe VFS. 


There are several special files & directories in the /boot/ directory: 


e /boot/  startup.data : the standalone data including the mainstack, extensions and auxiliary stackfiles and 
startup script. 
e /boot/fonts/basefont.ttf : the font used by the engine 


e /boot/standalone/ : the defaultFolder when the engine starts, and the location where additional assets 
selected using the "Copy files" page of the standalone builder are placed 


In general, if you wish to add new files or directories to the standalone.zip archive, it is best to add them outside 
the /boot/ directory tree. 
Advanced: Embedding an HTML5 standalone in a web page 


The default HTML5 page provided by the HTML5 standalone builder is designed for testing and debugging 
purposes. However, you may want to embed the standalone engine in a more visually appealing page. To do this, 
you require three elements: 1) a canvas, 2) a JavaScript Module object, and 3) an HTML <script> element that 
downloads the engine. 


The canvas 


The engine renders into aHTML5 <canvas> element contained within a <div> element. There are some important 
considerations when creating the canvas & div: 


e both the canvas and div must have absolutely no border, or mouse coordinate calculations will be incorrect 


e they will be automatically resized by the engine to match the size of your stack, so don't attempt to set their size 
using HTML or CSS 


e the canvas should be the only element within the containing div, which may be used to hold additional elements 
as native layers are added to the app. 


e the canvas needs to be easily uniquely identifiable, so that the engine can find it. 


The absolute minimum canvas element would look something like this: 





<div><canvas style="border: Opx none;" id="canvas" oncontextmenu="event.preventDefault 
();"></canvas></div> 


By default, most web browsers will indicate when the canvas has focus by displaying a highlighted outline. This helps 
users identify which part of the web page is capturing their key presses. You can usually disable this outline by 
adding outline: none; to the canvas's CSS styles. 


The Module object 
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The top-level JavaScript Module object contains the parameters that control how the engine runs. At minimum, you 


need only specify the Module.canvas , which should be your canvas element. 
The absolute minimum Module object declaration would look something like: 


<script type="text/javascript"> 


var Module = { 





canvas: document.getElementById('canvas'), 
}; 
<6 /:SiC Tastee 


Engine download 


The engine is quite a large JavaScript file, so it's downloaded asynchronously in order to let the rest of the page 
finish loading and start being displayed. 


Quite straightforwardly: 


<script async type="text/javascript" src="standalone-<version>.js"></script> 


Make sure to replace <version> as appropriate. 


Bringing it all together 


Here's the complete skeleton web page for an HTML5 standalone: 


<<initemale> 
<body> 
<div> 





<canvas style="border: Opx none;" id="canvas" oncontextmenu="event.preventDefau 
1t()"></canvas> 


</div> 


<script type="text/javascript"> 





var Module = { canvas: document.getElementById('canvas') Ne 
<G//S Cries 
<script async type="text/javascript" src="standalone-community.js"></script> 
</body> 
</html> 


Advanced: Speeding up engine download 


Currently, the engine files are almost 30 MB, which is a lot to download before the engine can start. It is possible to 
speed up the download by enabling deflate compression in the web server configuration. 


Enabling deflate compression reduces the total download size to around 6.3 MB. It's recommended to pre-compress 
the engine with gzip , and then configure your web server to serve the pre-compressed files. 
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e For the Apache web server, configure mod deflate to serve pre-compressed content 
e For the NGINX web server, add gzip static on; to your configuration. 


Advanced: Customizing the Module object 


There are a number of LiveCode-specific Module attributes that you can modify to affect how the engine behaves: 


e Module.livecodeStandalone : the filename of the standalone archive (default standalone.zip ) 

¢ Module.livecodeStandalonePrefixURL : Prepended to the standalone archive filename to construct its full URL 
(default empty) 

e Module.livecodeStandaloneRequest : If you assign a network request to this attribute (before the engine runs), 
then it will use that request for the standalone archive instead of automatically starting a download for you. This 
means that you can, in your HTML, fire off a request for the standalone before the engine script actually arrives. 
For this to work, the network request should be an xMLHttpRequest Withits responseType set 


to arraybuffer. 


See also Emscripten's Module object documentation. 


Bug Reports 
@0e Standalone Application Settings for Untitled 1 - Bug Reports 
fy ios @ 
it me X «a A ios & *% 
General Stacks Copy Files Mac Windows Linux iOS Android HTML5 Bug Reports 





Include Error Reporting Dialog 


htmlText for dialog: 


Dialog icon: BD 
Allow user to enter comments 
Allow user to save report to file 
Allow user to email report 


Email Address: 





Figure 14 — Standalone Settings — Bug Reports 


Include Include an error reporting stack in your standalone. You should select this option if you are 
Error testing your application and want details of any errors in your standalone, or if you have not 
Reporting included your own error reporting routines in your stacks. 

Dialog 
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htmlText The text to display to the user in the dialog that comes up when an error is encountered. 
fordialog This text should be in LiveCode-compatible HTML format. Create and format the text in a 
LiveCode field then copy the field's HTMLText property. 


Dialog The icon to display in the error dialog. This should be stored as an image in your stack. 
icon 


Allow user Display a box for the user to give you more information. This information will be included in 
to enter the report. 
comments 


Allow user Allow the user to save the report to a file. Select this option if you want users to save an 
to save error report and send it to you. 

report to 

file 


Allow user Allow the user to email the report. Select this option if you want the user to be able to send 

to email you or your technical support department details of the error. This option loads up the 

report system default email client and populates the email with the contents of the error report and 
the user's comments. The To: field is sent to the email address specified in the email 
address field. 


Testing Your Application 


Testing an app is straightforward: 

1) Open your stack in the LiveCode IDE 

2) Select File — Standalone Application Settings... from the menu bar 
3) Select the settings for your app 


4) Make sure that checkboxes for each platform you wish to build for are checked as the chosen platforms will 
govern which test targets are available. 


5) Close the standalone settings window 
6) Choose Development — Test Target — Your Target from the menu bar to select the target to test deployment to 
7) Click the Test button or choose Development — Test from the menu bar 


8) The standalone will be built and deployed to the target and launched. If you have the pro features pack, then the 
remote debugger will detect any execution errors and present them. 


Note: iOS devices connected via USB are detected as test targets when you have the pro features pack and 
apps will be installed on them, however, they will not be automatically launched. 
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